home *** CD-ROM | disk | FTP | other *** search
/ Best of www.BestZips.com (Collector's Edition) / Best of WWW.BESTZIPS.COM Collector's Edition (JCSM Shareware) (JCS Marketing).ISO / grapprog / splt252.zip / SPLOT.DOC < prev    next >
Text File  |  1994-09-11  |  71KB  |  1,501 lines

  1.  
  2.  
  3.            S P L O T  -  The Pen Plotter Simulator V2.52
  4.            ---------------------------------------------
  5.            Copyright (C) 1989-94 by Alexandr NOVY
  6.                  All rights reserved.
  7.  
  8.  
  9.  
  10.       U S E R ' S   M A N U A L   F O R   MS-DOS   V E R S I O N
  11.       ----------------------------------------------------------
  12.                   July 1994
  13.  
  14.  
  15.  
  16.  
  17.                 1. INTRODUCTION
  18.                 ---------------
  19.  
  20.           The SPLOT program is  a highly effective tool  intended for
  21.         simulating the pen plotter on the display of an IBM PC.   The
  22.         SPLOT program is  the very thing  you need to  make your work
  23.         with the plotter more effective. The SPLOT program will  give
  24.         you a guarantee you will always draw on your plotter what you
  25.         really want. That is why it will save your nerves, your time,
  26.         your plotter, pens and paper, that means your money.
  27.  
  28.  
  29.          The SPLOT program can offer:
  30.  
  31.          - active support of about 50 HP-GL instructions (according
  32.        to the type of your plotter).
  33.  
  34.          - active support of 20 DXY-GL instructions (for ROLAND
  35.            plotters).
  36.  
  37.          - possibility of exporting a  picture to the printer and  in
  38.            this way to obtain an output of a high quality. The  SPLOT
  39.            program uses the  best graphics resolutions  available for
  40.            each printer  that it  supports and  optionally uses  data
  41.            packing to improve transfer speed.  In this way the  SPLOT
  42.            program will  make a  fast and  excellent plotter  of your
  43.            printer. It supports all usual types of printers including
  44.            color ones.
  45.  
  46.          - exporting  a  picture  to  the  HP-GL,  HP-GL/2,  DXY-GL,
  47.        PLOTCALL,  DXF  and  PostScript  formats.
  48.  
  49.          - possibility of making picture cuts (the ZOOM function). In
  50.            this way you can scan,  draw on the plotter or  print only
  51.            the selected part of the picture.
  52.  
  53.          - possibility  of  completing  the  picture  with  a    text
  54.            including multilingual characters - in this way the  SPLOT
  55.            program will teach  your plotter German  (Spanish, French,
  56.            etc.)  easily  and  quickly  without complicated switching
  57.        between  character  sets!   The  built-in  HP-GL or DXY-GL
  58.            exports respectively, will make it possible. Due to  these
  59.            exports it is also possible:
  60.  
  61.            -  to  offer  a  highly  optimized output for your plotter
  62.              (where each pen is grasped only once).
  63.  
  64.            - to  teach  your  plotter  the advanced instructions  you
  65.              would get only  if you buy  a more expensive  plotter or
  66.              additional  hardware  (e.g.,   the  SPLOT  program   can
  67.              simulate  connecting  an  additional  HP 17440A graphics
  68.              enhancement cartridge to the HP 7440A ColorPro plotter).
  69.  
  70.  
  71.         The SPLOT program can be used by:
  72.  
  73.         - anybody who wants to work with his plotter in the WYSIWYG
  74.           style (What You See Is What You Get).
  75.  
  76.         - anybody  who  wants  to  develop  his  own plotter  program
  77.           applications.   You  can  reach  it  with the SPLOT program
  78.           easily even if you do not own the plotter at all!
  79.  
  80.         - anybody  who  wants  to  use  his  printer  as  a   plotter
  81.           occasionally or constantly. In  many cases using a  printer
  82.           may be faster and moreover, this may be an alternative of a
  83.           high quality.
  84.  
  85.         - anybody who wants to program a printer in graphics mode and
  86.           at  a  high  level  and  who  does  not  want  to   develop
  87.           complicated software which would enable it. In these  cases
  88.           using  the  HP-GL  language  in  connection  with the SPLOT
  89.           program  seems  to  be  very  advantageous for creating own
  90.           graphics outputs. The HP-GL  language can  be learned  very
  91.           easily and in addition, it offers unexpected possibilities.
  92.  
  93.  
  94.  
  95.           The  SPLOT  program  is   available  in  various   versions
  96.         according to  the type of simulated plotter. This  means that
  97.         each SPLOT.EXE  module is  designated for  a certain  plotter
  98.         type.   This  principle  gives  the  maximum  reliability  of
  99.         simulation of the given plotter type. At present versions for
  100.         the following plotter types are at your disposal:
  101.  
  102.            Plotter type                          | Plotter syntax
  103.          ------------------------------------------------------------
  104.        HP 7470A                              | HP-GL
  105.        HP 7475A                              | HP-GL
  106.        HP 7440A ColorPro                     | HP-GL
  107.        HP 7550A                              | HP-GL
  108.        HP 7570A/7575A/7576A DraftPro DXL/EXL | HP-GL
  109.        HP 7595A/7596A DraftMaster I/II       | HP-GL
  110.        ROLAND DXY 1100/1200/1300             | DXY-GL / RD-GL I
  111.        ROLAND GRX 300/400                    | RD-GL II
  112.  
  113.       An UNREGISTERED COPY  of the program  is available only  in
  114.         the version for the HP 7475A plotter. The versions for  other
  115.         plotter types can  be received only  on the basis  of regular
  116.         registration. See next chapter  for licensing, evaluation and
  117.         registration information or see file LICENCE.DOC for details.
  118.  
  119.           The  SPLOT  program  is  designated  for  using with IBM PC
  120.         computers  and  compatibles,  and  for  the MS-DOS and PC-DOS
  121.     version  3.00  and  higher  ones ( the MS-WINDOWS version  is
  122.     available too ).  In the  DOS version  graphics  cards EGA or
  123.     VGA  are  required.  To  run  the  program  comfortably it is
  124.     recommended to use a Microsoft Mouse or a compatible one.
  125.  
  126.  
  127.  
  128.                 2. LICENSING, EVALUATION and REGISTRATION INFORMATION
  129.                 -----------------------------------------------------
  130.  
  131.         SPLOT  is  distributed  as  "Shareware"  or  "User  Supported
  132.         Software"  and  is  fully  copyrighted.  If  you register the
  133.         program you will receive these benefits:
  134.  
  135.           1) The latest version of SPLOT.
  136.           2) A printed user's manual.
  137.           3) A printed technical reference which describes
  138.              all plotter instructions supported by SPLOT.
  139.           4) An end to the nag screens and opening banners.
  140.           5) Deep discounts on the next major versions.
  141.           6) A collection of useful utilities:
  142.              - BPRINT.COM - prints binary files on a printer
  143.                             on time background with many options.
  144.              - BPLOT.COM  - plots files on a pen plotter on time
  145.                             background with many options.
  146.              - CLPT.COM - redirects printer ports to a disk file.
  147.              - CPORT.COM - redirects serial ports to a disk file.
  148.  
  149.  
  150.         The  single  user  registration  fee  for SPLOT is $70.00 US.
  151.         The multisystem site fee for SPLOT is $150.00. Users  outside
  152.         of   Europe   should   include   an   additional   $5.00  for
  153.         international airmail.
  154.  
  155.     Author can accept payment in these three ways:
  156.  
  157.      1) In cash (money enclosed) - this is the most quick method,
  158.         but at your risk.
  159.  
  160.      2) Credit card  -  MasterCard, VISA and American Express are
  161.         accepted.  Please,  fill out  carefully  the  credit card
  162.         information in order form.
  163.  
  164.      3) Bank or travelers cheque enclosed - please make  a cheque
  165.         payable in US funds.
  166.  
  167.      4)  Author can send to you first an invoice with an  account
  168.         number.  Then you will receive the SPLOT program as  soon
  169.         as your payment will be done to this account number.
  170.  
  171.     Since the SPLOT program is always distributed in the  version
  172.     adapted for a certain plotter type, do not forget to  mention
  173.     the  plotter  type  with  which  you  want  to  use the SPLOT
  174.     program.  A list of plotters you can choose from is given  in
  175.     the  first  chapter  or  in  the  PLOTTERS.DOC  file.  In the
  176.     PLOTTERS.DOC  file  there  are  also  given the parameters of
  177.     these   plotters   together   with   a   list   of  supported
  178.     instructions. It makes possible to choose a suitable  plotter
  179.     type even if  your plotter is  not listed (most  plotters are
  180.     compatible with some plotter from the list).  Of course,  you
  181.     can order more SPLOT  program versions for different  plotter
  182.     types.  In this case the single user registration fee for any
  183.     further version is  $20.00 (+ $5.00  outside Europe) and  the
  184.     multisystem site fee is $40.00 (+ $5.00 outside Europe). This
  185.     principle  is  also  valid  for  an  upgrade.   If  you  have
  186.     registered at  least one  SPLOT program  version at  the full
  187.     price of $70.00 ($150.00), now and in the future only  $20.00
  188.     ($40.00) is to be paid for all other versions.
  189.  
  190.     Special offer:
  191.     Registered  users  of  the  MS-Windows  version  of the SPLOT
  192.     program  can  order  the  MS-DOS  version  for  $50.00   only
  193.     ( $100.00 for the multisystem site licence ) (+ $5.00 outside
  194.     Europe). In this  case fill out  your serial number  in order
  195.     form and mark  it as `upgrade  from Windows version'.
  196.     Note:  The latest MS-Windows version of the SPLOT program  is
  197.     available  on  all  SIMTEL20  archives  in   <MSDOS.WINDOWS3>
  198.     directory as SPLTXXXW.ZIP file (recently SPLT221W.ZIP).
  199.  
  200.  
  201.         To register, please use the registration/order form  supplied
  202.     with this package (as provided in the file ORDER.FRM).
  203.     Please send the completed form along with a payment to:
  204.  
  205.             Alexandr Novy
  206.             Havlickova 2209
  207.             390 01 TABOR
  208.             Czech Republic
  209.  
  210.         NOTE: Czech users of SPLOT should contact Czech distributor
  211.  
  212.           PESKA & BRTNA Computer Service
  213.           Krakovska 2805
  214.           390 05 Tabor
  215.           Czech Republic
  216.           Tel./Fax 0042-361-42138
  217.  
  218.               or
  219.  
  220.               SOFTECH
  221.           P.O.B. 69
  222.           323 00 Plzen 23
  223.               Czech Republic
  224.               Tel./Fax  0042-19-226294
  225.  
  226.               A special Czech language version of the package is
  227.           available from them as well.
  228.  
  229.  
  230.                        EVALUATION AGREEMENT
  231.  
  232.         SPLOT  is not  and  has never been  public  domain  software,
  233.         nor is it free software.
  234.  
  235.         Non-licensed users are granted a limited license to use SPLOT
  236.         on  a  14-day  trial  basis  for  the  purpose of determining
  237.         whether SPLOT is suitable for their needs.  The use of SPLOT,
  238.         except for the initial 14-day trial,  requires  registration.
  239.         The use of unlicensed copies of SPLOT by any person,business,
  240.         corporation or any other entity is strictly prohibited.
  241.  
  242.         No one may modify or  patch the SPLOT executable file  in any
  243.         way, including but not limited to decompiling, disassembling,
  244.         or otherwise reverse engineering the program.
  245.  
  246.         A limited  license is  granted to  copy and  distribute SPLOT
  247.         only  for  the  trial  use  of  others,  subject to the above
  248.         limitations, and also the following:
  249.  
  250.         1) SPLOT must be  copied in unmodified form,  complete
  251.            with the file containing this license information.
  252.  
  253.         2) The full machine-readable SPLOT documentation  must
  254.            be included with each copy.
  255.  
  256.         3) SPLOT  may not  be distributed  in conjunction with
  257.            any other product without a specific license to  do
  258.            so from author.
  259.  
  260.         4) No  fee,  charge,  or  other  compensation  may  be
  261.            requested or accepted, except as authorized below:
  262.  
  263.            a) Operators of  electronic bulletin board  systems
  264.               (sysops)   may   make   SPLOT   available    for
  265.               downloading as long as the above conditions  are
  266.               met.   An overall  or time-dependent  charge for
  267.               the  use  of  the   bulletin  board  system   is
  268.               permitted as  long as  there is  not a  specific
  269.               charge for the download of SPLOT.
  270.  
  271.            b) Vendors of user-supported or shareware  software
  272.               may  distribute  SPLOT  after  obtaining written
  273.               permission  from  author.  Such  permission   is
  274.               usually granted. Vendors may charge a reasonable
  275.               disk duplication and handling fee.
  276.  
  277.  
  278.  
  279.                        LICENSING AGREEMENT
  280.  
  281.         Licensed user are bound to the following licensing agreement.
  282.  
  283.         You may not transfer your license without written  permission
  284.         from author.  A single  user license  permits a  user to  use
  285.         SPLOT only on a single computer at a time.
  286.  
  287.         This product is distributed  AS IS.  The  author specifically
  288.         disclaims all  warranties, expressed  or implied,  including,
  289.         but not limited to, implied warranties of merchantability and
  290.         fitness for a particular  purpose with respect to  defects in
  291.         the diskette and  documentation, and program  license granted
  292.         herein,  in  particular,  without  limiting  operation of the
  293.         program license with  respect to any  use or purpose.   In no
  294.         event shall the author  be  liable for any loss of  profit or
  295.         damage  including  but  not  limited  to special, incidental,
  296.         consequential or other damages.
  297.  
  298.         By licensing SPLOT you agree to the above licensing agreement.
  299.  
  300.  
  301.  
  302.                 3. THE SPLOT WORKING PRINCIPLES
  303.                 -------------------------------
  304.  
  305.           The plotter  simulation consists  in  interpreting  plotter
  306.         instructions contained  in a  disk file.   The SPLOT  program
  307.         reads these instructions from the file and plots them on  the
  308.         screen of the computer in  the same way as the  plotter would
  309.         do  on  paper.  The  file  is  plotted  in  the  window which
  310.         represents the plotting paper of the plotter.  The boundaries
  311.         of this window normally correspond to the hard clip limits of
  312.         the plotter (i. e., to the physical limits in which a plotter
  313.         pen  can  move  for  the  selected  paper  size). If the ZOOM
  314.         function is used,  the chosen plotting  area is displayed  in
  315.         this window.
  316.  
  317.  
  318.  
  319.                 4. WORKING WITH THE PROGRAM
  320.                 ---------------------------
  321.  
  322.           The SPLOT program can be  operated using the keyboard or  a
  323.         mouse. From the keyboard the program is operated by  pressing
  324.         the keys the list of which is given in chapters 4.2 and  4.3.
  325.         If you have a mouse installed, its cursor will appear on  the
  326.         screen.  The shape of the cursor is a cross which appears  in
  327.         the plotting  area (paper)  (see chapter  4.1), outside  this
  328.         area it is a rectangle of  one letter size.  The function  of
  329.     this cursor is to choose, activate and change items displayed
  330.         visually. You can make a  choice by moving the cursor  on the
  331.         selected item  and by  pressing any  button of  the mouse. At
  332.         this moment a  tick off character  appears on the  cursor and
  333.         only after releasing the pressed button the action associated
  334.     with the selected item is  realized. If you choose from  more
  335.         items in the menu (e.g., choosing a file to be plotted),  you
  336.         have to make a double  click since the first pressing  serves
  337.         to highlighting an item.
  338.  
  339.           The program can perform plotting the chosen file on one  of
  340.         two pages, they are called "a small view" and "a large  view"
  341.         here.
  342.  
  343.           A small view is used for setting the chosen parameters  and
  344.         selecting  the  file  to  be  plotted.  The  file can be also
  345.         plotted in a small area.
  346.  
  347.           The choice of the file to be plotted can be made either  by
  348.         entering its name  or by choosing  it from the  menu. In this
  349.         menu there are all the files of the given directory with  the
  350.         extension  .PLT  displayed  and   there  are  also  all   the
  351.         subdirectories the contents of which can be displayed  simply
  352.         by choosing a subdirectory from the menu. Any file group  can
  353.         be displayed also  by means of  the wildcards *  and ? (e.g.,
  354.         '*.*' will display all the files in the given directory).  As
  355.         soon as the file to be plotted is chosen, its plotting starts
  356.         on  the  page that is set up  by the F1 key (A SMALL VIEW  or
  357.         A LARGE VIEW).
  358.  
  359.           Plotting the file can be  stopped by pressing the keys  F1,
  360.         Esc, Ctrl-C or  Ctrl-Break at any  time. If the  plotting was
  361.         performed in a large view, after finishing plotting you  will
  362.         stay on the page of a large view.
  363.  
  364.           Returning from the large view page can be performed by  the
  365.         F1 key.
  366.  
  367.  
  368.  
  369.         4.1 ZOOMING
  370.                 -----------
  371.  
  372.           With the cursor run by the mouse or the keyboard resp., you
  373.     can make and enlarge the chosen cuts of the plotted area. The
  374.         control of the cursor is realized by the mouse control or  by
  375.         pressing the appropriate keyboard keys.
  376.  
  377.           There are two possible zoom modes named SLACK and EXACT.
  378.           In the SLACK mode the aspect ratio of the displayed cut  is
  379.         identical to the aspect  ratio of the original  plotting area
  380.         regardless of the aspect ratio of the selected cut. To ensure
  381.         proportional aspect ratio of  the displayed cut in  the SLACK
  382.         mode the  size of  the displayed  cut area  is usually larger
  383.         than the size of the selected cut area.
  384.           In the EXACT mode the aspect ratio of the displayed cut  is
  385.         exactly identical to  the aspect ratio  of the selected  cut.
  386.         To ensure proportional aspect  ratio of the displayed  cut in
  387.         the EXACT mode the screen plotting area is usually reduced.
  388.           You can set the default zoom mode in the OPTIONS menu  (see
  389.         chapter 6). However you  can apply the opposite  mode without
  390.         this setting (see below).
  391.  
  392.  
  393.       The movement of  the cross cursor  in the plotting  area is
  394.         realized by the mouse movement or by pressing the  Ctrl+arrow
  395.         keys (or plain  arrow keys in  large view).   By pressing any
  396.         mouse button or the Ins(ert) key when the cross cursor is  in
  397.     the plotting area you define first corner of the zooming box.
  398.         The next  mouse movement  or the  pressing of  the arrow  (or
  399.     Ctrl+arrow) keys expands and contracts the zooming box around
  400.         the area you desire to expand. If the Scroll Lock is switched
  401.         on or  the Shift  key is  pressed, or  if you  press the left
  402.         mouse button with the right mouse button simultaneously,  the
  403.         box moves as a whole.  By pressing the right mouse  button or
  404.     by pressing  the Enter  key you  can start  zooming. Starting
  405.     zooming with the Ctrl key depressed selects the opposite zoom
  406.         mode to  the default  (i.e., when  the default  zoom mode  is
  407.     SLACK  (EXACT),  you  must  press  Ctrl+right mouse button or
  408.     Ctrl+Enter key to perform zooming in EXACT (SLACK) mode). The
  409.         left button or  the Esc key  or the Ins(ert)  key cancels the
  410.         box cursor mode and  you get back to  the mode of the  simple
  411.         movement of the cross cursor.
  412.  
  413.       To expand the picture into the original size press the  Tab
  414.         key or  press both  the mouse  buttons simultaneously  in the
  415.         cross cursor mode.
  416.  
  417.           If you have a  three button mouse with  appropriate driver,
  418.         pressing the  middle mouse  button is  equivalent to pressing
  419.         the right and left buttons simultaneously.
  420.  
  421.           Note  that  in  the  small  view  the  Enter and arrow keys
  422.         normally serve  for control  of the  file menu  and the  edit
  423.     line. However in  the mode of  defining the zooming  box they
  424.         serve for this operation.
  425.  
  426.  
  427.  
  428.                 4.2  LIST OF KEYS IN "A SMALL VIEW"
  429.                 -----------------------------------
  430.  
  431.         F1 - It selects "A SMALL VIEW" or "A LARGE VIEW" for plotting
  432.              the file.
  433.  
  434.         F2 - The choice of a disk.
  435.  
  436.         F3 - It replots the selected file in the given picture box.
  437.  
  438.         F4 - The choice of parameters. In the menu initiated by  this
  439.              key it  is possible  to set  various program  parameters
  440.              concerning  also  exporting  a  picture to the supported
  441.              formats. See chapter 6 for more details.
  442.  
  443.         F5 - It changes the paper size according to the plotter  type
  444.              and the selected paper norm.
  445.  
  446.         Alt_F5 -  It switches  among the  paper norms (ISO,ANSI,ARCH)
  447.              defining the paper size according to the plotter type.
  448.  
  449.         Ctrl_F5, Alt_E - It switches  the EXPAND mode on and  off (on
  450.              condition it is supported for the given plotter type).
  451.  
  452.     F6 - In the ROLAND plotter version it switches between  RD-GL
  453.          and   DXY-GL   command   mode   (Note: the  RD-GL syntax
  454.              corresponds with the HP-GL syntax). In some versions  it
  455.              makes  a  choice  of  the  plotter  type (e.g. in the HP
  456.              DraftPro   version   it   switches   among   the   types
  457.              7570A/7575A/7576A). In the version for HP 7440A ColorPro
  458.              it switches on  or off the  simulation of the  HP 17440A
  459.              graphics enhancement cartridge.
  460.  
  461.         Alt_F6,Alt_U - In the  ROLAND plotter version in  DXY-GL mode
  462.              it changes the  plotter unit size  from 0.1 mm  to 0.025
  463.              mm.  In RD-GL mode  or HP-GL mode the plotter  unit size
  464.              is always 0.025 mm.
  465.  
  466.         Alt_F7, Alt_F - In the  ROLAND plotter version the choice  of
  467.              an initial font (the font set up after switching on  the
  468.              plotter or after its initialization).
  469.  
  470.         F7 - It switches on or off a multilingual TEXT filter in  the
  471.              LB command of HP-GL mode (or in the P command of  DXY-GL
  472.              mode  of  the  ROLAND  plotter).  See chapter 7 for more
  473.          detailed information.
  474.  
  475.         F8 - It activates  the export  of the  displayed part of  the
  476.              HP-GL or DXY-GL  file to alternative  formats (including
  477.              printing).  See chapter 5 for more details.
  478.  
  479.         F9 - It switches  on or  off the  tracing of  the  individual
  480.              plotter commands during plotting  the file. It is  valid
  481.              only  for  "A  LARGE  VIEW".  First  every  command   is
  482.              executed,  then  it  is  displayed  in  the  information
  483.              window.  The  next  command  is  executed after pressing
  484.              Enter  or  F7.  In  this  mode  the  S key or the F8 key
  485.              switches on  and off  automatic tracing.  The tracing is
  486.          disabled during printing or exporting.
  487.  
  488.         F10 - It stops  the program.  The program  can be stopped  by
  489.              using the F10 key practically at any moment.
  490.  
  491.         Alt_1 - Alt_0 - The identification of pens. See chapter 9 for
  492.              more details.
  493.  
  494.     Alt_P - The information about assigning colors to pens.
  495.  
  496.         Alt_S - It saves the  selected palette of colors assigned  to
  497.              individual pens to be registered in the setup file.
  498.  
  499.         Alt_R - It restores the original palette unless the saving of
  500.              the palette has been already done.
  501.  
  502.         Alt_I - The initialization of graphics mode (it can be  used,
  503.              e.g., if the screen graphics mode is damaged -  possibly
  504.              by a popup resident program).
  505.  
  506.         Alt_V -
  507.         Alt_F10 - Video configuration. More details in chapter 8.
  508.  
  509.  
  510.  
  511.                 4.3  LIST OF KEYS IN "A LARGE VIEW"
  512.                 -----------------------------------
  513.  
  514.     F3, F4, F8, F9, F10,
  515.         Alt_F10, Alt_V
  516.         Alt_P, Alt_S, Alt_R, Alt_I - See "A SMALL VIEW".
  517.  
  518.     F1 - The return to the page of "A SMALL VIEW".
  519.  
  520.     F2 - Opens a file selection dialog. Pressing F2 in this
  521.          dialog opens a drive selection dialog.
  522.  
  523.         1 - 0
  524.         Alt_1 - Alt_0 - See the identification of pens (chapter 9).
  525.  
  526.         F5 - Inserting a text  into the picture and the  manipulation
  527.              with it (see chapter 7 for more detailed information).
  528.  
  529.     Page_Up, Page_Dn - It switches between informative pages.  On
  530.                  the  first  page  there  is  the  size  of a plotted
  531.                  picture box expressed  in mm units.   On the  second
  532.                  page there is the  position in the plotted  file and
  533.                  the  position  of  the  cursor  in the plotting area
  534.                  expressed in plotter units. On both the pages  there
  535.                  are  the  most  important  parameters describing the
  536.                  state of the plotter.
  537.  
  538.  
  539.  
  540.                 5. EXPORT
  541.                 ---------
  542.  
  543.           The SPLOT program  enables to export  a plotted picture  to
  544.         the following formats:
  545.  
  546.                 - HP-GL
  547.         - HP-GL/2
  548.                 - DXY-GL (ROLAND)
  549.                 - PLOTCALL
  550.                 - DXF (AutoCAD)
  551.                 - POSTSCRIPT (color)
  552.                 -----------------
  553.                 - IBM Graphics (IBM 9 pin printer)
  554.                 - IBM X24 (IBM 24 pin printer)
  555.                 - EPSON LX
  556.                 - EPSON EX/FX (color)
  557.                 - EPSON LQ (color)
  558.         - NEC 24 pin (color)
  559.                 - HP LaserJet
  560.                 - HP DeskJet (color)
  561.                 - HP PaintJet (color)
  562.                 - HP QuietJet
  563.                 - HP ThinkJet (HP mode)
  564.  
  565.           The HP-GL format executes  the export of a  plotted picture
  566.         to the HP-GL  plotter. It can  be employed, for  example, for
  567.         plotting a picture  cut on the  plotter, for the  output of a
  568.         multilingual text on the plotter (see chapter 7), or in  case
  569.         your  plotter  does  not  support  all  the  HP-GL   commands
  570.         supported  by   the  SPLOT   program.   The   last  case   is
  571.         characteristic especially  of the  situation you  own the  HP
  572.         ColorPro  7440A  plotter  and  you  have  not  the additional
  573.         graphics enhancement cartridge HP 17440A.
  574.  
  575.           The HP-GL/2 format can be  used for exporting a picture  to
  576.     any HP-GL/2 device. It may be a pen, ink-jet or electrostatic
  577.     plotter as well as a printer of any type. The HP-GL/2 is  the
  578.     standardized next generation  of the HP-GL  ( Hewlett-Packard
  579.     Graphics Language ).
  580.  
  581.           The DXY-GL format realizes the  export of a picture to  the
  582.         DXY plotter (usually the ROLAND plotter).
  583.  
  584.       The PLOTCALL  format is  used in  the GoldenSoftware's PLOT
  585.         program which  supports a  wide range  of peripheral  devices
  586.         (printers, plotters).
  587.  
  588.           The DXF format converts a  picture to a form applicable  by
  589.         the AutoCAD program. From AutoCAD you can read this DXF  file
  590.         via the DXFIN command. The exported picture is written in the
  591.         form  of  LINES  where  each  pen  of the plotter has its own
  592.         LAYER. Pen  1 has  a layer  with the  name PEN1,  pen 2 has a
  593.         layer with the name PEN2, etc.
  594.  
  595.           The PostScript format can be used by any peripheral  device
  596.         which  has  implemented   PostScript  interpreter  (such   as
  597.         PostScript printer).
  598.  
  599.           The function of the other formats is to export a picture to
  600.         the corresponding peripheral devices - printers. The  (color)
  601.         word  indicates  a  possibility  of  color  printing  for the
  602.         appropriate format. Naturally, all formats can be used on all
  603.         printers compatible with these ones.
  604.  
  605.           The picture  can be  exported either  to the  disk file  or
  606.         directly to the corresponding peripheral device (a plotter, a
  607.         printer).  If  your  peripheral  device  is  connected to the
  608.         parallel interface, use PRN or LPT1 resp., LPT2, etc. as  the
  609.         output file. If it is connected to the serial interface,  use
  610.         COM1  or  COM2  respectively.  Set  the  parameters  of   the
  611.         corresponding serial interface by  the DOS MODE command  with
  612.         the parameter "p" beforehand, like this:
  613.  
  614.              MODE COM1:9600,,,,p
  615.  
  616.       If  you  export  a  picture  to  a disk file, which is less
  617.     time-consuming, you can use  the enclosed  programs BPLOT  or
  618.     BPRINT resp.,  for exporting  this file  to the corresponding
  619.     peripheral device  (in the  registered version  only).  These
  620.     programs  perform  exporting  files  to  the chosen serial or
  621.     parallel interface, on the time background.  Please,  realize
  622.     that it  is not  possible to  use the  DOS PRINT  command for
  623.     exporting binary files  (the files containing  graphics data)
  624.     to the printer.
  625.  
  626.       The export of the picture is started with the F8 key. In the
  627.     EXPORT menu you can specify:
  628.        - an exporting format,
  629.        - the size of the resultant picture,
  630.        - resolution (the size of a plotter unit) - in the case of
  631.          the DXY-GL export only,
  632.        - print density - if exporting to the printer,
  633.        - the output file name.
  634.  
  635.       You can choose from the following export sizes:
  636.        - ZOOM size,
  637.        - ORIGINAL size,
  638.        - A3, A4 or A5 size,
  639.        - USER size.
  640.  
  641.       The ZOOM size is offered only if a zoom cut is exported. It
  642.     is exactly identical  to the original  size of the  displayed
  643.     cut (1:1 scaling). When  the HP-GL, HP-GL/2 or  DXY-GL export
  644.     is performed it is possible to keep the original position  of
  645.     the  selected  cut  (note  that  the optional left and bottom
  646.     margins are added to this  position too - for specifying  the
  647.     left and  bottom margins  see chapter  6).   This way you can
  648.     make an HP-GL, HP-GL/2 or DXY-GL picture which contains  more
  649.     selected cuts positioned as on original picture.
  650.  
  651.       The ORIGINAL size is the whole size of the selected plotter
  652.     paper size (as defined by the F5, Alt_F5 or Ctrl_F5 keys). If
  653.     you use  this size  for exporting  the original  (non-zoomed)
  654.     image, you ensure the 1:1 scale for that export.
  655.  
  656.       The A3, A4 and A5 sizes are the predefined sizes.
  657.  
  658.           To  ensure  proportional  aspect  ratio  of  the  resultant
  659.         picture for ORIGINAL, A3, A4 and A5 sizes, only the one  side
  660.         from  selected  size  is  used.  This  determinant  side   is
  661.         displayed in bright color. The other side is counted so  that
  662.         the resultant picture would be proportional.  By default  the
  663.         choice  of  the  determinant  side  is  performed so that the
  664.         resultant size  lies entirely  within the  selected size. You
  665.         can override this by selecting the other determinant side. To
  666.         do this click  on the non-bright  side item or  press the Tab
  667.         key.
  668.  
  669.       The USER size serves for setting of the user defined  size.
  670.     If you set your  own size of the  output format, you have  to
  671.     give  only  the  size  of  the  one  side , the other side is
  672.     counted automatically so that the resultant picture would  be
  673.     proportional. Use the Tab key  or mouse control to switch  to
  674.     the editing of the desired side.
  675.  
  676.       The size is  given in cm  units or inch  units according to
  677.     the choice  from the  OPTIONS menu  (see chapter  6). The DXF
  678.     format is an exception -  here the output size is  understood
  679.     in units to be defined in AutoCAD.
  680.  
  681.       The  chosen  size  corresponds  with  the  real size of the
  682.     resultant picture realized by  exporting. It is necessary  to
  683.     consider it as the maximum  limits into which a picture  seen
  684.     in   the   program   plotting   area   can   be   transformed
  685.     proportionally. Therefore, for example, if you choose A4 size
  686.     paper  as  the  output  size  for  printing and if you have a
  687.         printer  of  the  same  size,  you  will reach a satisfactory
  688.         result only if you choose the LANDSCAPE orientation. For  the
  689.         PORTRAIT orientation it is necessary to choose the maximum A5
  690.         size for the  output so that  the resultant picture  could be
  691.         positioned on A4 size paper.
  692.  
  693.           The other parameters influencing the look of the  resultant
  694.         picture  can  be  set  in  the  menu activated by F4 key (see
  695.         chapter 6).
  696.  
  697.  
  698.  
  699.         6. OPTIONS
  700.         ----------
  701.  
  702.     With the menu activated by the F4 key it is possible to set:
  703.  
  704.     1. DEFAULT EXTENSIONS - this item sets default extensions
  705.          of the following file types:
  706.        1.1 PLOT FILES - the files given in the menu of files from
  707.          which  the  files  for  plotting  are  selected. For
  708.          example, if this extension is PLT, the displaying of
  709.          all  the  files  with  the  PLT  extension  will  be
  710.          standard. If this extension is *, the displaying  of
  711.          all the files will be standard.
  712.        1.2 HP-GL EXPORT -
  713.        1.3 HP-GL/2 EXPORT -
  714.        1.4 DXY-GL EXPORT -
  715.        1.5 PLOTCALL EXPORT -
  716.        1.6 DXF EXPORT  -
  717.        1.7 POSTSCRIPT EXPORT -  sets standard  extensions  of the
  718.          output files according to  the  type of  export. The
  719.                  name of the output file is composed of the base part
  720.          derived  from  the name of  the exported file + this
  721.                  standard extension.  However, the  file name  of the
  722.                  output file can be  changed before the beginning  of
  723.          any export.
  724.            1.8 PRINT - sets  standard extensions of the  output files
  725.                  during  exporting  a  picture  designated  for   the
  726.                  printer.
  727.        1.9 TEXT - sets the standard extension of the output  file
  728.          determined for storing texts on the disk.
  729.  
  730.         2. SORT ORDER FOR FILES - the choice of order in which  files
  731.                  are displayed. The sorting can be done by the  NAME,
  732.                  EXTENSION or SIZE.
  733.  
  734.     3. BACKGROUND - switches between NORMAL  and BRIGHT intensity
  735.          of background white color  of plotting area  (paper)
  736.          (in color modes only).
  737.  
  738.     4. VIDEO SETUP - more detailed information in chapter 8.
  739.  
  740.     5. SOUND - switches on and off sound signals.
  741.  
  742.     6. DEFAULT ZOOM - sets the default zoom mode as SLACK or
  743.         EXACT (see chapter 4.1 for details).
  744.  
  745.     7. PEN WIDTHS  -   this  menu  item  enables  you  to  manage
  746.         a variable  pen widths feature  provided by the SPLOT
  747.         program:
  748.       7.1 SET PEN WIDTHS -  It  determines  the line  width   for
  749.         individual  pens.  By  default  the  line  width   is
  750.         determined  by  the  PT  (pen thickness) instruction.
  751.         The   line   width   is   controlled   by  the  HP-GL
  752.         instructions and   will  vary   according  to   value
  753.         issued  in  PT  instruction.  However note that  each
  754.         SP (select pen) instruction  resets  the  PT  to  its
  755.         default  value (mostly 0.3 mm).
  756.         The other way is to set the line width to fixed  user
  757.         defined value.  Unlike the  other measurement  values
  758.         the line width is expressed in millimeters (mm).
  759.       7.2 USE ON SCREEN - Check  this  option if you want  to use
  760.         variable pen widths for screen drawing.
  761.       7.3 USE ON PRINTER - Check  this option if you want to  use
  762.         variable pen widths for printing and for HP-GL/2  and
  763.         PostScript exporting (the variable pen widths are not
  764.         supported  for  HP-GL,  DXY-GL,  PLOTCALL and AutoCAD
  765.         exports).
  766.       7.4 ON PRINTER -  Select here  a mode  for use  of the  pen
  767.             widths when printing or exporting. It can be:
  768.         Absolute  -  a  real  printed  line  width  will   be
  769.                absolutely  equal  to  the  specified  pen
  770.                width.
  771.         Relative - a real printed line width will be computed
  772.                from the specified pen width relatively to
  773.                the  original  plotter  page  size (or its
  774.                printed cut).
  775.         Only  checking  of  the  relative  mode  can   ensure
  776.         printing in  the WYSIWYG  style. However  by checking
  777.         the absolute mode  along with PT  width type for  all
  778.         pens you get a native plotter simulation.
  779.         Note  that  on  screen  the  pen  widths  are  always
  780.         displayed in relative mode.
  781.       7.5 ZOOM PEN WIDTHS  -  Check  this option  if you  want to
  782.         enlarge the pen widths  along with enlarging an image
  783.         cut (see the ZOOMING section).
  784.  
  785.  
  786.     8. TEMPORARY  PATH -  this menu  item sets  the directory  in
  787.            which  the  SPLOT  program  will  create its auxiliary
  788.            files  in  some  types  of  picture  exporting. If the
  789.            picture   exporting   stops   with  an  error  message
  790.            "DISK FULL", it means,  that there  is not  sufficient
  791.            disk space for the  created output or auxiliary  file.
  792.            In the latter  case you can  try to set  the temporary
  793.            directory to another disk.  You can choose from  three
  794.            possibilities:
  795.        8.1 The directory defined by the environment variable  TMP
  796.            by means of the DOS SET command (e.g., SET TMP=D:\).
  797.        8.2 The directory defined by the environment variable TEMP.
  798.        8.3 A current work directory i.e., the directory given  on
  799.            the  information  board  of  the  program  in "a small
  800.            view".
  801.  
  802.     9. USED UNITS  - it defines  units used for  setting the size
  803.         and distances during picture exporting. The units may
  804.         be given in cm (centimeters) or inch (inches).
  805.  
  806.     A. EDIT USER COLORS - sets the RGB values of the user colors.
  807.         They can be used in the PEN --> COLOR assignments for
  808.         PostScript and  HP-GL/2 exports.  The RGB  values are
  809.         expressed in percents.
  810.  
  811.     B. Parameters for the HP-GL EXPORT :
  812.       B.1 PEN --> PEN - by  means of this item it is  possible to
  813.         assign each  pen on  the input  a pen  on the output.
  814.         Thus  it  is  possible,  for  example, to convert the
  815.         picture that uses more pens to a single colored  one,
  816.         or it is  possible to exclude  using some pen (if you
  817.         assign PEN 0 as the output pen to it).
  818.       B.2 PEN OPTIMIZATION - if ON, the number of the grasping of
  819.         pens when the picture is exported will be  optimized.
  820.         This means that when the resultant  picture is  being
  821.         drawn, each pen is grasped only once.
  822.       B.3 PEN ORDER - specifies the sequence of pens according to
  823.         which the optimized picture will be drawn.
  824.       B.4 OUTPUT FORMAT can be like this:
  825.           * NORMAL - every HP-GL  command is given on a  separate
  826.              line and it is ended with a character ";".
  827.           * PACKED - all the HP-GL  commands follow closely   one
  828.              after  another  without  any separators. The
  829.              number of uses of PU and PD instructions  is
  830.              minimized.
  831.       B.5 ORIGIN IN CENTER - Activate this parameter only if  the
  832.         resultant HP-GL file is designated for the plotter in
  833.         which the origin of the coordinate system is situated
  834.         in the center of the plotting area (it is usual  with
  835.         large paper size  plotters,  e.g. HP  DraftPro or  HP
  836.         DraftMaster).
  837.       B.6 LEFT MARGIN -  specifies   the offset of  the  exported
  838.         picture from the left margin - it is on the X axis  -
  839.         it can also be a negative number.
  840.       B.7 BOTTOM MARGIN - specifies the  offset of the   exported
  841.         picture from the bottom margin - it is on the Y  axis
  842.         - it can also be a negative number.
  843.       B.8 90 DEGREES ROTATION - It determines  the orientation of
  844.         an  exported  picture.  The 90  degrees  rotation  is
  845.         forced by the RO90 instruction.
  846.       B.9 PG AT END - specifies if the PG (Page Feed) instruction
  847.         will be attached to the end of the output file.
  848.  
  849.     C. Parameters for the HP-GL/2 EXPORT :
  850.       C.1 DEVICE TYPE - select here to which HP-GL/2 device type
  851.         you will export. It can be:
  852.          * PEN PLOTTER
  853.          * MONOCHROME (B&W) RASTER DEVICE (e.g. electrostatic
  854.            plotter, laser printer etc.)
  855.          * COLOR RASTER DEVICE (e.g. color ink-jet plotter or
  856.            printer etc.)
  857.       C.2 DUAL CONTEXT DEVICE - for raster devices it  determines
  858.         if  the  device  supports  along  with  HP-GL/2   the
  859.         Hewlett-Packard's  printer  command  language  (PCL).
  860.         Check  your  printer/plotter  documentation  to   see
  861.         whether or not your device supports this extension.
  862.       C.3 PEN --> PEN - see the HP-GL export.
  863.             Valid for PEN PLOTTER device type only.
  864.       C.3 PEN --> COLOR  -  It  assigns   the  output  colors  to
  865.         individual pens for the RASTER COLOR device type.
  866.       C.3 PEN --> SHADE  -  It  assigns   the  output shades   to
  867.         individual pens for the RASTER B&W device type.
  868.         The shades are expressed in percents. The value of 0%
  869.         represents black pen, the  value of 100%   represents
  870.         white pen  and other  values represent  corresponding
  871.         gray levels.
  872.       C.4 PEN OPTIMIZATION - see the HP-GL export.
  873.             Valid for PEN PLOTTER device type only.
  874.       C.5 PEN ORDER - see the HP-GL export.
  875.             Valid for PEN PLOTTER device type only.
  876.       C.6 OUTPUT FORMAT - see the HP-GL export.
  877.       C.7 LEFT MARGIN - see the HP-GL export.
  878.       C.8 BOTTOM MARGIN - see the HP-GL export.
  879.       C.9 90 DEGREES ROTATION - see the HP-GL export.
  880.       C.A USE PS INSTRUCTION - switches  on or off  using of  the
  881.             PS (plot size) instruction in  the  HP-GL/2   output.
  882.         Allowing  the  use  of  PS  instruction is especially
  883.         useful  with  plotters  drawing  on rollfeed media to
  884.         avoid paper waste  when  drawing  a  small size plot.
  885.         However using PS instruction on a dual context device
  886.         can scale the resultant picture by the picture  frame
  887.         scaling factor (that is the ratio of the PCL  picture
  888.         frame size to the HP-GL/2 plot size).
  889.       C.B PLOT FRAME ADVANCE  - Set  this option  to VERTICAL  if
  890.           your  plotter  frame  advance  is  parallel  with the
  891.           longer side of paper.  Set this option to  HORIZONTAL
  892.         if your  plotter frame  advance is  parallel with the
  893.           shorter side of paper.
  894.       C.C ENABLE CUTTER -  enables   or  disables  the  automatic
  895.             cutter  function  of  your  HP-GL/2  plotter.  If the
  896.         cutter is enabled,  cutting is done  after exporting.
  897.         Note:  Not  all  devices  have  an  automatic cutter.
  898.           Rollfeed devices that do not have a cutter may draw a
  899.         line where the paper should be cut.
  900.       C.D MEDIA TYPE - selects  the type of media loaded  in your
  901.           HP-GL/2 device. Your device uses this information  to
  902.         change  resolution,  drop  volume,  alter  plot/print
  903.         speed,   change   from   bidirectional   printing  to
  904.         unidirectional  printing   etc.  according   to   its
  905.         plotting  or  printing   technology,  quality   level
  906.         setting, internal knowledge of  the pen type and  any
  907.         control-panel setups.
  908.       C.E QUALITY LEVEL -  specifies the  quality level  of  your
  909.         output from 0 (draft quality) to 100 (presentation or
  910.         final quality).  On raster  devices  it  can optimize
  911.         a toner usage  when final  quality  is not necessary.
  912.         For a pen plotter, quality level is primarily a speed
  913.           control. The pen speed  set by the plotter's  control
  914.           panel  is  the  maximum  speed  which  corresponds to
  915.            quality level of 0. If the pen speed is not set,  the
  916.           plotter  determines  the  maximum  speed based on its
  917.         knowledge of media type  and pen type. Minimum  speed
  918.         (corresponding to quality  level of 100)  is linearly
  919.         interpolated between the media and pen types.
  920.         Note: The default quality level in the SPLOT  program
  921.         is 0  (maximum speed)  for pen  plotters and  100 for
  922.         raster devices.
  923.  
  924.     D. Parameters for the DXY-GL EXPORT:
  925.       D.1 PEN --> PEN - see the HP-GL export.
  926.       D.2 PEN OPTIMIZATION - see the HP-GL export.
  927.       D.3 PEN ORDER - see the HP-GL export.
  928.       D.4 OUTPUT FORMAT can be like this:
  929.            * NORMAL - every DXY-GL command is given on a separate
  930.               line.
  931.            * PACKED - all the DXY-GL commands follow closely  one
  932.               after another  without any  separators. The
  933.               number of uses of  M and D instructions  is
  934.               minimized.
  935.       D.5 ORIGIN IN CENTER - activate this parameter only if  the
  936.         resultant DXY-GL file  is designated for  the plotter
  937.         whose origin of the  originate system is situated  in
  938.         the center of the plotting area.
  939.       D.6 LEFT MARGIN - see the HP-GL export.
  940.       D.7 BOTTOM MARGIN - see the HP-GL export.
  941.  
  942.     E. Parameters for the PLOTCALL EXPORT:
  943.       E.1 NUMBER OF DECIMAL DIGITS - It determines the number  of
  944.         figures  written  after  the  decimal  point  at  the
  945.         numbers on the output.
  946.       E.2 PEN --> PEN  - see the HP-GL export.
  947.       E.3 LEFT MARGIN - see the HP-GL export.
  948.       E.4 BOTTOM MARGIN - see the HP-GL export.
  949.  
  950.     F. Parameters for the DXF EXPORT:
  951.       F.1 NUMBER OF DECIMAL DIGITS - see the PLOTCALL export.
  952.       F.2 PEN --> PEN  - see the HP-GL export.
  953.       F.3 LEFT MARGIN - see the HP-GL export.
  954.       F.4 BOTTOM MARGIN - see the HP-GL export.
  955.  
  956.     G. Parameters for the POSTSCRIPT EXPORT:
  957.       G.1 PEN --> COLOR  -  It  assigns   the  output  colors  to
  958.         individual pens for the color PostScript export.
  959.       G.2 PEN --> SHADE  -  It  assigns   the  output  shades  to
  960.         individual  pens  for  the  black & white  PostScript
  961.         export. The  shades are  expressed in  percents.  The
  962.         value of  0% represents black pen,  the value of 100%
  963.         represents  white  pen  and  other  values  represent
  964.         corresponding gray levels.
  965.       G.3 LEFT MARGIN - specifies   the offset of  the   exported
  966.         picture from the left margin - it is on the X axis  -
  967.         it can also be a negative number.
  968.       G.4 BOTTOM/TOP MARGIN  -   specifies  the   offset  of  the
  969.         exported picture from the bottom margin (when the  90
  970.         degrees  rotation  is  suppressed)  or  from  the top
  971.         margin (when the 90  degrees rotation is demanded)  -
  972.         it is  on the  Y   axis -  it can  also be a negative
  973.         number.
  974.       G.5 90 DEGREES ROTATION - It determines the orientation of
  975.         an exported picture.
  976.  
  977.  
  978.     H. ALL PRINTERS - It sets   up various  parameters valid  for
  979.         printing on all kinds of printers:
  980.       H.1 ORIENTATION -   It  determines  the  orientation  of  a
  981.         printed  picture on the paper.  It may be either  the
  982.         LANDSCAPE orientation (breadthwise)  or  the PORTRAIT
  983.         orientation (heightwise).
  984.       H.2 FRAME - It  determines if  a printed  picture is  to be
  985.         situated in the frame limiting the plotted area.
  986.       H.3 PEN FOR A FRAME - It determines  the number of the  pen
  987.         with which the frame  will be drawn. Its  function is
  988.         important for color printers, where the color of  the
  989.         frame is determined by assigning PEN --> COLOR.   The
  990.         frame is drawn always with a thin line regardless  of
  991.         the current pen widths settings.
  992.       H.4 PAGE BREAK AT END - specifies  if the page break  (form
  993.         feed) command  will be  attached  to the end  of  the
  994.         output file.
  995.       H.5 LEFT MARGIN - specifies the distance from the left stop
  996.         of  the  printhead  to  the  start  printing position
  997.         independently of the orientation.
  998.       H.6 TOP MARGIN - specifies the size of shift of the printer
  999.         platen before starting printing independently of  the
  1000.         orientation.
  1001.          The  LEFT MARGIN  and  TOP MARGIN  parameters  enable to
  1002.          place the printed picture in any place on the paper.  At
  1003.          laser printers which have neither printheads nor platens
  1004.          in a classic  sense of word,  the terms LEFT  MARGIN and
  1005.          TOP MARGIN always  relate to the  paper oriented in  the
  1006.          vertical   position   independently   of   the   picture
  1007.          orientation on the paper.
  1008.  
  1009.     I.  DOT MATRIX PRINTERS -  In  this  item it is  possible  to
  1010.         increase the  number of  the printhead  passes during
  1011.         printing.  It can be used for emphasizing printing or
  1012.         when the ribbon is written up.
  1013.  
  1014.     J. Parameters for IBM X24 - it sets parameters for the IBM
  1015.           24 pin printers:
  1016.       J.1 OUTPUT FORMAT can be like this:
  1017.            * NORMAL - without use of relative shift instructions.
  1018.            * PACKED - the instructions for the relative shift  of
  1019.               the  printhead  are  used  for reducing the
  1020.               output  code  size.
  1021.       J.2 PANASONIC X24 - switches on and off Panasonic X24  mode
  1022.          in which is used a different format for selecting  a
  1023.          base line feed unit. This format is not strictly IBM
  1024.          compatible and should be used with Panasonic 24  pin
  1025.          printers in X24 mode.
  1026.  
  1027.     K. Parameters for EPSON - it sets parameters for the EPSON
  1028.           printers:
  1029.       K.1 OUTPUT FORMAT can be like this:
  1030.            * NORMAL - without use of relative shift instructions.
  1031.            * PACKED - the instructions for the relative shift  of
  1032.               the  printhead  are  used  for reducing the
  1033.               output  code  size  (not  used for EPSON LX
  1034.               printers), but on  some older types  it may
  1035.               cause substantial reducing print rate.
  1036.       K.2 PEN --> COLOR  - It   assigns   the  output  color   to
  1037.         individual pens  on the  color printers  of the EPSON
  1038.         EX/LQ type. It is possible to choose from a fixed set
  1039.         of 7 colors.
  1040.  
  1041.     L. Parameters for NEC 24 - it sets parameters for the NEC 24
  1042.           pin printers:
  1043.       L.1 OUTPUT FORMAT can be like this:
  1044.            * NORMAL - without use of relative shift instructions.
  1045.            * PACKED - the instructions for the relative shift  of
  1046.               the  printhead  are  used  for reducing the
  1047.               output  code  size.
  1048.       L.2 PEN --> COLOR  - It   assigns   the  output  color   to
  1049.         individual pens on the NEC 24 pin color printers.  It
  1050.         is possible to choose from a fixed set of 8 colors.
  1051.  
  1052.     M. Parameters for HP LaserJet - it sets parameters for the HP
  1053.         LaserJet printers:
  1054.       M.1 OUTPUT FORMAT can be like this:
  1055.            * NORMAL - no special coding used.
  1056.            * PACKED - special  coding   is used for  reducing the
  1057.               output code size. This coding is NOT a
  1058.               standard feature of the HP LaserJet and
  1059.               compatible printers and you must be sure
  1060.               that your laser printer supports this (it
  1061.               must support ESC*b1M instruction - I have
  1062.               tested this on the HP LaserJet IIIp model).
  1063.  
  1064.     N. Parameters for HP DeskJet - it sets parameters for  the HP
  1065.         DeskJet printers:
  1066.       N.1 OUTPUT FORMAT can be like this:
  1067.            * NORMAL - no special coding used.
  1068.            * PACKED - special  coding   is used for  reducing the
  1069.               output code size. This coding is a standard
  1070.               feature of the HP DeskJet printers.
  1071.       N.2 PEN --> COLOR -  It  assigns   the   output   color  to
  1072.         individual pens for color printing on the  HP DeskJet
  1073.         printer. It is possible to choose from a fixed set of
  1074.         7 colors.
  1075.  
  1076.     O. Parameters for HP PaintJet - it sets parameters for the HP
  1077.         PaintJet printers (but not for XL300 model):
  1078.       O.1 OUTPUT FORMAT can be like this:
  1079.            * NORMAL - no special coding used.
  1080.            * PACKED - special  coding   is used for  reducing the
  1081.               output code size. This coding is a standard
  1082.               feature of the HP PaintJet printers.
  1083.       O.2 PEN --> COLOR -  It  assigns   the   output   color  to
  1084.         individual pens for color printing on the HP PaintJet
  1085.         printer.  It  is  possible  to  choose  from  a fixed
  1086.         (standard) or variable (extended) set of colors. Both
  1087.         color sets have 7 colors.  The extended color set can
  1088.         be redefined by user from offer of 17 colors.
  1089.       O.3 COLOR SET  -   switches  between standard and  extended
  1090.         color  set.  The  selected  color  set  is  used  for
  1091.         defining assignment PEN --> COLOR.
  1092.       O.4 EXTENDED COLOR SET - It is used  for setting individual
  1093.         colors in the  extended color set.   If the  extended
  1094.         color set is  selected as used  color set, then  if a
  1095.         color  in  this  set  is  changed,  the corresponding
  1096.         assignment  PEN --> COLOR  is changed  automatically.
  1097.       O.5 MEDIA TYPE -  It selects  output media type -  paper or
  1098.         foil.
  1099.  
  1100.     P. Parameters for HP PaintJet XL300 - it sets parameters for
  1101.         the HP PaintJet XL300 printer:
  1102.       P.1 OUTPUT FORMAT can be like this:
  1103.            * NORMAL - no special coding used.
  1104.            * PACKED - special  coding   is used for  reducing the
  1105.               output code size. This coding is a standard
  1106.               feature of the HP PaintJet XL300 printer.
  1107.       P.2 PEN --> COLOR -  It  assigns   the   output   color  to
  1108.         individual pens for color printing on the HP PaintJet
  1109.         XL300 printer.  It is possible to choose from a fixed
  1110.         set of 7 colors.
  1111.  
  1112.  
  1113.     Q. TEXT FILTER  - It switches on or off  a multilingual  TEXT
  1114.         filter in the LB command  of HP-GL mode (or in  the P
  1115.         command of  DXY-GL mode  of the  ROLAND plotter). See
  1116.         chapter 7 for more detailed information.
  1117.  
  1118.     R. CODE PAGE SELECTION  -  It  sets a  code page  for a  text
  1119.         filter (see chapter 7).  The code page can  look like
  1120.         this:
  1121.         - United States
  1122.         - German
  1123.         - Multilingual
  1124.         - Portugal
  1125.         - Canada - French
  1126.         - Norway
  1127.  
  1128.  
  1129.  
  1130.         7. INSERTING TEXTS INTO PICTURES
  1131.         --------------------------------
  1132.  
  1133.       The SPLOT program is able to process a multilingual text in
  1134.     your HP-GL (or DXY-GL) files. As known, plotters receive only
  1135.     the ASCII characters in the range of 0 to 127.  Therefore, if
  1136.     the instruction for the output of the text (LB at HP-GL and P
  1137.     at DXY-GL resp.) contains the ASCII characters with the value
  1138.     higher  than  127,  the  plotter  will  not draw them or will
  1139.     ignore  the  highest  bit  of  characters  and  will draw the
  1140.     corresponding characters  from the  lower half  of the  ASCII
  1141.     table.  For  example, if you  use the following  statement in
  1142.     GW-BASIC (handle #1 represents the plotter),
  1143.  
  1144.         PRINT #1, "LBGröße";CHR$(3)
  1145.  
  1146.     the plotter will draw only the text
  1147.  
  1148.         Gre  or  Grae  respectively.
  1149.  
  1150.         If you want to draw the  text correctly, you have to use  the
  1151.        following statements, e.g.:
  1152.  
  1153.             PRINT #1, "CS0;CA33;SS;LBGr";CHR$(3)
  1154.             PRINT #1, "SA;LB|~";CHR$(3)
  1155.             PRINT #1, "SS;LBe;CHR$(3)
  1156.  
  1157.         However,  e.g.,  if  you  own  the  HP ColorPro 7440A plotter
  1158.         without an  additional HP  17440A graphics cartridge, it will
  1159.         not help you either.
  1160.  
  1161.         The  above  mentioned  example  concerns  the use of a German
  1162.         text,  but  similar  problems  occur  also in other languages
  1163.         which use  the ASCII  characters from  the upper  half of the
  1164.         table.
  1165.  
  1166.         Therefore, the SPLOT program offers the TEXT FILTER  function
  1167.         with the  F7 key.  If you  switch on  this function,  all the
  1168.         ASCII  characters  from  the  value  of  128  to  175  and  ß
  1169.         character will be plotted according to the selected code page
  1170.         (see chapter 6).  And  it does not matter what  character set
  1171.         of  the  plotter  is  just  set.  This will enable  to  write
  1172.         multilingual  texts  in  your  HP-GL  (DXY-GL) files directly
  1173.         without complicated  switching of  character sets.  The HP-GL
  1174.         (DXY-GL) file created in this  way must be exported to  a new
  1175.         HP-GL (DXY-GL)  form through  the HP-GL  (DXY-GL) export (see
  1176.         chapter 5) with the TEXT filter switched on, and only such  a
  1177.         newly originated file can be drawn on the plotter.
  1178.  
  1179.         To demonstrate  using this   method of  writing  multilingual
  1180.         texts  we   recommend  you   to  study   over  the   enclosed
  1181.         demonstration file ASCII.PLT and display it at first with the
  1182.         TEXT filter being switched off and then on.
  1183.  
  1184.  
  1185.  
  1186.           Another function which the SPLOT program can offer for your
  1187.         work  with  the  HP-GL  text   is  the  function  of   direct
  1188.         (interactive) inserting texts into a picture. To do it, it is
  1189.         necessary to define its  position (XY), size (SI),  direction
  1190.         (DI), slant (SL), the character set number (CS), the selected
  1191.         pen (SP) and, naturally, the text itself.
  1192.  
  1193.           By means of the menu activated by the F5 key on the page of
  1194.         a  large  view  you  can  choose  the  following   individual
  1195.         functions necessary for the text manipulation :
  1196.  
  1197.          - define a new text item
  1198.          - edit already existing items
  1199.          - read the text items from the disk file
  1200.          - save the text items to the disk file
  1201.  
  1202.           On defining, editing or reading texts the SPLOT program  is
  1203.         brought  into  the  initial  state  which  corresponds   with
  1204.         executing IN;RO;IP;IW; instructions. The user's scale (if  it
  1205.         was set before) and rotation,  if there is any,  is cancelled
  1206.         then. The  position of  the text  is given  in plotter  units
  1207.         absolutely, the size  of the text  is in cm  (SI) absolutely,
  1208.         the direction of the text is also in degrees (DI) absolutely,
  1209.         the slant is  understood as a  tangent of the  required angle
  1210.         (SL).
  1211.  
  1212.           The position of the text and its size can be defined either
  1213.         by setting numeric  values from the  keyboard or by  moving a
  1214.         quadrangle which  demonstrates the  outline of  the text  and
  1215.         which is  controlled by  the mouse  in a  similar way as when
  1216.     making picture cuts (zooming). To do this it is necessary  to
  1217.         move the cursor  of the mouse  to the plotting  area. Then by
  1218.         pressing the  left button  and moving  the mouse  at the same
  1219.         time the position of the text changes, by pressing the  right
  1220.         button and moving the mouse at the same time the size of  the
  1221.         text changes. The other values are set in a numeric form from
  1222.         the keyboard.
  1223.  
  1224.           Of course,  the text  itself can  be written  in a  desired
  1225.         language  with  the  ASCII  characters  >  127.  In the HP-GL
  1226.         (DXY-GL) picture these characters will be displayed according
  1227.         to the  code page  you will  choose in  the OPTIONS menu. The
  1228.         corresponding  support  of  the  national environment must be
  1229.         installed in MS-DOS  (it must support graphics modes) if  you
  1230.         want to have the same characters on the edit line.
  1231.  
  1232.           The  function  of  direct  inserting  a  text  accepts  the
  1233.         following keys :
  1234.  
  1235.           a) when  defining  a  new  text item or correcting  already
  1236.              existing text items:
  1237.  
  1238.                Alt_T - setting the text string for plotting
  1239.  
  1240.                Alt_X - setting the position of the text (X,Y) [pu]
  1241.  
  1242.                Alt_S - setting the size (X,Y) [cm] (i.e. the size  of
  1243.                        one text character)
  1244.  
  1245.                Alt_D - setting the direction of the text [deg]
  1246.  
  1247.                Alt_L - setting the slant of the text
  1248.  
  1249.                Alt_C - setting the character set number
  1250.  
  1251.                Alt_P - setting the  number of a pen for  plotting the
  1252.                        text
  1253.  
  1254.                F1    - finishing  the editing of  the text with   the
  1255.                        changes saved
  1256.  
  1257.                F2    - the redrawing of the edited text
  1258.  
  1259.                F9 or Esc - finishing   the editing  of the text  with
  1260.                            canceling the changes
  1261.  
  1262.           b) when correcting already existing text items :
  1263.  
  1264.                F3 - skip to the correction of the previous text  item
  1265.                     (if it exists)
  1266.  
  1267.                F4 - skip to the correction of the next text item  (if
  1268.                     it exists)
  1269.  
  1270.                F6 - the choice of a text item for correcting (if  you
  1271.                     have defined more than one text item)
  1272.  
  1273.                F8 - the  canceling (erasing  from memory)  of a  text
  1274.                     item according to your choice
  1275.  
  1276.           In this  way it  is possible  to define  any number of text
  1277.         items  that  are  loaded  into  memory  and  after  finishing
  1278.         plotting the respective file they are drawn.
  1279.  
  1280.           It is  supposed that  the set  of the  text items  you have
  1281.         created relates to the plotted file. That is why when  coming
  1282.         to the plotting of  a new file (i.e.  when the plotting of  a
  1283.         file is  activated otherwise  than by  the F3  key or  F8 key
  1284.         resp.), all  the text  items are  always erased  from memory.
  1285.         Before it happens, the program enables to put the text on the
  1286.         disk if you did not do that before.
  1287.  
  1288.         There are two ways how to save the created texts :
  1289.  
  1290.         1) In the  HP-GL (or DXY-GL  resp.) form in  the plotted file
  1291.            (according to the item in the menu in the ORIGINAL  file).
  1292.            Respective commands for plotting the defined text items on
  1293.            the plotter are attached to  the end of the plotted  file.
  1294.            After the texts are saved on the disk in this manner, they
  1295.            are always erased from memory of the program, even if  you
  1296.            do not start plotting a  new file. This is the  final form
  1297.            of storing texts  which you can  use on condition  you are
  1298.            already satisfied with the  created texts and you  want to
  1299.            attach them to the displayed file for ever. If you want to
  1300.            display the texts  together with the  plotted file on  the
  1301.            plotter or on  the printer and  you do not  want to attach
  1302.            the texts to the original file for ever, use directly  the
  1303.            appropriate export format  with the F8  key (as the  texts
  1304.            loaded in the  memory of the  program are also  exported).
  1305.            Then  you  can  put  the  texts  on  the disk in the other
  1306.            described way.
  1307.  
  1308.         2) In a special format in a EXTRA file.  Only the texts saved
  1309.            in such a  way can be  read into the  program memory later
  1310.            again and thus you can continue in their editing.
  1311.  
  1312.  
  1313.  
  1314.  
  1315.                 8. VIDEO CONFIGURATION
  1316.                 ----------------------
  1317.  
  1318.           The  SPLOT  program  is  a  graphics  program  requiring  a
  1319.         graphics  card  EGA  or  VGA  and  supporting  the  following
  1320.         graphics modes:
  1321.  
  1322.           1) monochrome mode
  1323.  
  1324.              - EGA 640x350
  1325.  
  1326.           2) 16 color modes
  1327.  
  1328.              - EGA 640x350
  1329.              - VGA 640x380
  1330.              - SUPER EGA 640x480, 640x258, 800x600
  1331.          - SUPER VGA 800x600, 1024x768, 1280x1024
  1332.  
  1333.           The choice  of the  required mode  can be  made in the menu
  1334.         which is initiated by the Alt_F10 key or Alt_V key resp.   In
  1335.         this menu there are the following items :
  1336.  
  1337.          - AUTOMATIC MODE  - is determined  to set up  the video mode
  1338.               automatically according to the type of a video card and
  1339.               according to this it sets up the following modes:
  1340.               - EGA mono 640x350
  1341.               - EGA 16 color 640x350
  1342.               - VGA 16 color 640x480
  1343.  
  1344.          - BIOS MODE - is determined  to set up the mode you  require
  1345.               according  to  the  number  and  resolution.  The  mode
  1346.               numbers together with the appropriate resolution should
  1347.               be given  in the  documentation of  your graphics card.
  1348.               The BIOS  mode   number  is  to   be  set  in   decimal
  1349.               units standardly, if you want to set it in  hexadecimal
  1350.               units, write the H character  at  its end. This  way of
  1351.               setting the video mode is useful if you own an EGA card
  1352.               or  VGA card with high  resolution (SUPER EGA  or  VGA)
  1353.               and  you will  not find it in  the list of SUPER  cards
  1354.               offered  by the SPLOT program.
  1355.  
  1356.       - SUPER VIDEO  CARDS - contains  the lists of  SUPER EGA or
  1357.           VGA  cards  divided  according  to resolution (640x480,
  1358.           640x528, 800x600, 1024x768, 1280x1024).  Even  if  your
  1359.           card is not  in the list,  it is  possible that it will
  1360.           function when you choose  another card of the list.  In
  1361.           the other case you can try to set the  required mode by
  1362.           means of the BIOS MODE item  (except the resolutions of
  1363.           1024x768  and  1280x1024  which  are  highly   hardware
  1364.           dependent).
  1365.           Notice - not all listed SVGA cards have been tested.
  1366.           Only standard VESA video modes are supported (not OEM).
  1367.  
  1368.       - the other items of  the menu contain standard EGA  or VGA
  1369.         modes  in  which  the  SPLOT  program  can work (EGA mono
  1370.             640x350, EGA color 640x350 and VGA color 640x480). It  is
  1371.             possible to set any of  these three modes on VGA,  but on
  1372.             the  EGA  cards  it  is  possible  to  set only EGA modes
  1373.             according to the type  of the connected monitor  (mono or
  1374.             color).
  1375.  
  1376.           - the last item of the menu called `VGA GRAY-SCALE'  serves
  1377.             to  switch  ON/OFF  the  gray-scale  summing on VGA video
  1378.             adapter.  You will need switch ON this option in case you
  1379.             have an VGA video adapter with mono monitor and your  VGA
  1380.             adapter   doesn't   perform   the   gray-scale    summing
  1381.             automatically.   The  gray-scale  summing  enables use of
  1382.             color video modes  along with VGA  mono monitor.   If the
  1383.             gray-scale summing is  active, each color  is transformed
  1384.             to  corresponding  gray  level  and  thus you are able to
  1385.             distinguish  individual  colors  even  when  using a mono
  1386.             monitor.   If the  gray-scale summing  is inactive,  some
  1387.             colors are  undistinguishable on  mono monitor  (e.g., in
  1388.             SPLOT program you may not see some pen colors unless  you
  1389.             change its color value). The `VGA GRAY-SCALE' item is not
  1390.             displayed  if  your  video  adapter  or active video mode
  1391.             doesn't support it.
  1392.  
  1393.  
  1394.  
  1395.                 9. PEN IDENTIFICATION
  1396.                 ---------------------
  1397.  
  1398.           The identification of pens  serves to emphasizing parts  of
  1399.         the picture drawn  with the same  pen and to  informing about
  1400.         the number  of pens  used during  drawing the  given picture.
  1401.         This information is useful namely for the correct loading  of
  1402.         the plotter pens in case you decide to draw the given picture
  1403.         on the plotter.
  1404.  
  1405.           The keys from Alt_1 to Alt_0  in a small view and the  keys
  1406.         from 1 to 0 in a  large view are determined for indicating  a
  1407.         part of the picture drawn by the same pen.  If you press  the
  1408.         appropriate  key,  a  part  of  the  picture  drawn  by   the
  1409.         appropriate pen will begin to  flash and it will be  flashing
  1410.         until you press the key corresponding with the identification
  1411.         of another pen or if you do not cancel the identification  by
  1412.         pressing the Alt_0  key or 0  key resp.   This identification
  1413.         functions only in color video modes.
  1414.  
  1415.         Example: If you press  the key Alt_1 (in  a small view) or  1
  1416.                  (in a  large view)  resp., the  part of  the picture
  1417.                  drawn by the pen number 1 will begin to flash (Alt_2
  1418.                  or 2 resp. by the pen number 2, etc.).
  1419.  
  1420.           In color modes in the SPLOT program each pen is  associated
  1421.         with appropriate  color. It  is possible  to choose  from the
  1422.         palette of 62 colors for  each pen. You can change  the color
  1423.         of the pen when the identification of this pen is switched on
  1424.         by pressing  the Gray-Plus  key or  the Gray-Minus  key resp.
  1425.         (increasing or decreasing the number of the color  associated
  1426.         with this pen). When  the pen identification is  switched on,
  1427.         information about the color number of the pen in a large view
  1428.         is given in the right  bottom corner of the screen.  In large
  1429.         view you can change pen colors also after pressing the  Alt_1
  1430.         key, the Alt_2 key etc.  In this case there is no flashing of
  1431.         the part of the  picture as it is  in a small view,  but only
  1432.         information about the color number  of the pen, which can  be
  1433.         changed in  the described  way, appears  in the  right bottom
  1434.         corner.   You can  save the  palette of  the colors  you have
  1435.         chosen by  pressing the  Alt_S key,  or you  can restore  the
  1436.         original palette by the Alt_R key.
  1437.  
  1438.           The information panel containing the individual pen numbers
  1439.         serves to identify  the numbers of  pens used during  drawing
  1440.         the picture. At the beginning of drawing all the pen  numbers
  1441.         are  gray,   during  drawing   the  color   of  the    number
  1442.         corresponding with the  pen just being  used is white,  after
  1443.         finishing drawing the color of the numbers corresponding with
  1444.         all the used pens is white.
  1445.  
  1446.  
  1447.  
  1448.                 10. NOTES
  1449.                 ---------
  1450.  
  1451.         - When  the  SPLOT  program  is  started, it is in the  state
  1452.           corresponding with the state of the simulated plotter  just
  1453.           switched  on.  When  coming  to  plotting  a  new file, the
  1454.           program performs only the  operation of changing paper.  In
  1455.           this case the program (plotter) is in the state in which it
  1456.           has been left by the commands of the previous file. That is
  1457.           why  it  is  generally  recommended  to place an initiating
  1458.           command sequence  to the  beginning of  each file.  It will
  1459.           bring the plotter  to the well-known  state.  Otherwise  it
  1460.           can happen that the same  file can be drawn in  another way
  1461.           every time,  dependently of  the contents  of the  previous
  1462.           plotted files. The author recommends to use the  initiating
  1463.           sequence IN;RO;IP;IW; (in some plotters the IN command does
  1464.           not influence the setting of rotation).
  1465.             In  other  cases  the  program  is  brought  to the state
  1466.           corresponding with the switching off and on the plotter  in
  1467.           these cases:
  1468.            - at any change of the format or the paper size,
  1469.            - at the change of the language syntax (HP-GL <--> DXY-GL),
  1470.            - at  switching  on/off  the  simulation  of the  graphics
  1471.              cartridge HP 17440A (ColorPro).
  1472.  
  1473.         - After  finishing  the  SPLOT  program  saves  the important
  1474.           parameters (a palette of colors for pens, a choice of  view
  1475.           for plotting, a size of  paper, command mode, etc.) in  the
  1476.           SPLOT.INI file in  the directory in  which the program  EXE
  1477.           file is situated.  When starting the program, the SPLOT.INI
  1478.           file is used for resetting these parameters. If you want to
  1479.           set a permanent configuration of the program which will not
  1480.           be changed,set on the READ ONLY attribute of this file.
  1481.  
  1482.  
  1483.           NOTICE
  1484.  
  1485.           -  Hewlett-Packard, HP-GL, HP-GL/2, HP, DraftPro,
  1486.          DraftMaster, LaserJet, DeskJet and PainJet are
  1487.          registered  trademarks of the Hewlett-Packard Company.
  1488.  
  1489.           -  Microsoft,  MS,   MS-DOS  and  GW-BASIC  are  registered
  1490.              trademarks  and  Windows  is  a  trademark  of Microsoft
  1491.          Corporation.
  1492.  
  1493.           -  IBM and PC-DOS are registered trademarks of
  1494.              International Business Machines Corporation.
  1495.  
  1496.           -  EPSON is a registered trademark of EPSON Corporation.
  1497.  
  1498.           -  AutoCAD is a registered trademark of Autodesk, Inc.
  1499.  
  1500.       -  PostScript is a trademark of Adobe Systems, Inc.
  1501.